home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / archiver / lzhtv12.zip / LZHTV.DOC < prev    next >
Text File  |  1990-04-22  |  6KB  |  204 lines
  1.   
  2.   
  3.                                  L z h   T V
  4.   
  5.                              Version 1.2, 04-22-90
  6.   
  7.                     Online .LZH Directory/Text View Module
  8.                   for .LZH files made with LHARC10 and later
  9.  
  10.                                  LZHTV12.ZIP
  11.   
  12.           Copyright 1989, 1990 Samuel H. Smith;  ALL RIGHTS RESERVED
  13.   
  14.   
  15.                         This program is supported by:
  16.   
  17.                               The Tool Shop BBS
  18.                                  Phoenix, AZ
  19.                         (602) 279-2673 (2400) - Free node
  20.                         (602) 264-3969 (HST 9600)
  21.                         (602) 279-0230 (Hayes V9600)
  22.   
  23.   
  24. 'LzhTV' is a small LZH file text-view utility.   It allows you to
  25. directly list out text files in a LZH file without first extracting
  26. them.  This version includes full source code and is compatible with
  27. network filesharing.  Run LZHTV without parameters for a summary of
  28. command syntax.
  29.  
  30. This utility can be used as a simple DOOR in systems that can provide a
  31. valid filespec for LZH file viewing.
  32.  
  33. This utility is compatible only with Yoshi's LHARC10.EXE (and later)
  34. file formats.
  35.  
  36. Source code is included.  Some additional library files are required.
  37. Look for TOOL-INC.ZIP and TOOL-USE.ZIP from The Tool Shop BBS.
  38.  
  39.  
  40. USAGE
  41. =====
  42.  
  43.    LZHTV [-Pport] [-Tminutes] [-Llines] [-Mlines] [drive:\path\]FILE[.LZH]
  44.  
  45.    -Pn   Enables com port COMn and monitors carrier.
  46.          Local operation allowed with -P0.
  47.  
  48.    -Tn   Allows user to stay in program for n minutes.
  49.          The default is 10 minutes.
  50.  
  51.    -Ln   Specifies lines per page in 'more?' prompts.
  52.          The default is 23 lines per page.
  53.  
  54.    -Mn   Specifies maximum number of lines of viewing to allow per session.
  55.          The default is 500 lines per session.
  56.  
  57. Example PCBVIEW.BAT for PCBoard 14.0  (dos 3.3 and later)
  58. ------------------------------------
  59.    @LZHTV -p1 %1 >pcbview.txt
  60.  
  61.  
  62. Example PCBVIEW.BAT for PCBoard 14.0  (dos 3.2 and earlier)
  63. ------------------------------------
  64.    echo off
  65.    LZHTV -p1 %1 >pcbview.txt
  66.  
  67.  
  68. Example PRO-R.BAT for ProDoor 3.0 and later
  69. -------------------------------------------
  70.    :LZH
  71.    chkpath LZHTV %0 >>%3
  72.    if errorlevel 1 goto end
  73.    LZHTV -p%1 -t%2 >>%3 %4
  74.    if errorlevel 1 goto error
  75.    goto end
  76.  
  77.  
  78.  
  79. ENVIRONMENT VARIABLES
  80. =====================
  81.  
  82.    LZHTV uses BIOS calls to perform all display updates.  The program
  83.    attempts to automatically detect EGA 43 and VGA display modes so it
  84.    can adapt as needed.  Unfortunately, under some environments these
  85.    BIOS enquiries cause the program to freeze.  To avoid this, you may
  86.    need to add the following environment variable before first running
  87.    LZHTV:
  88.         SET OVCRT=ON
  89.  
  90.    LZHTV has the ability to access non-standard COM ports.    To use com
  91.    ports other than the normal COM1 and COM2, you can now insert the
  92.    following statements in your batch file:
  93.         SET COMBASE=nnnn        ;port base I/O address (decimal)
  94.         SET COMIRQ=n            ;port IRQ setting
  95.  
  96.  
  97. REVISION HISTORY
  98. ================
  99.  
  100. 4-21-89
  101.    Initial coding and release.
  102.  
  103. 1-3-90
  104.    Corrected logic to quickly respond to a "NO" response at a "more?"
  105.    prompt.
  106.  
  107. 2-4-90
  108.    Added automatic support for EGA 43 line screen modes.
  109.    Added -L option to control lines per page.
  110.  
  111.    Added support for non-standard COM port configurations.
  112.  
  113.    Added -M option to encourage users to download large text files
  114.    rather than viewing them entirely through ZIPTV.
  115.  
  116.    Added OVCRT=ON environment variable to disable EGA and VGA bios
  117.    checks, which conflict with some timeshare programs or with the BIOS
  118.    in some PCs.
  119.  
  120.    Added logic to enable "local mode" when a -p1 or -p2 option is used,
  121.    but carrier is not present initially.
  122.  
  123.    Added logic to allow text files containing only NEWLINE (line-feed)
  124.    characters as used on Unix and unix-like systems.
  125.  
  126. 4-5-90
  127.    Added support for DSZ-compatible COM3 through COM8 built-in com port
  128.    definitions.
  129.  
  130. LICENSE
  131. =======
  132.  
  133.    You may copy and distribute this program freely, provided that:
  134.        1)   No fee is charged for such copying and distribution, and
  135.        2)   It is distributed ONLY in its original, unmodified state.
  136.  
  137.    If you wish to distribute a modified version of this program, you MUST
  138.    include the source code.
  139.  
  140.  
  141.    SourceWare: What is it?
  142.    -----------------------
  143.  
  144.    SourceWare is my name for a unique concept in user supported 
  145.    software. 
  146.    
  147.    Programs distributed under the SourceWare concept always offer
  148.    complete source code.
  149.  
  150.    This package can be freely distributed so long as it is not modified
  151.    or sold for profit.  If you find that this program is valuable,  you
  152.    can send me a donation for what you think it is worth.  I suggest
  153.    about $10.
  154.  
  155.    Send your contributions to:
  156.       Samuel. H. Smith
  157.       5119 N. 11 ave 332
  158.       Phoenix, Az 85013
  159.  
  160.  
  161.    Why SourceWare?
  162.    ---------------
  163.  
  164.    Why do I include source code?  Why isn't the donation manditory?  The
  165.    value of good software should be self-evident. The source code is the
  166.    key to complete understanding of a program.  You can read it to find
  167.    out how things are done.  You can also change it to suit your needs,
  168.    so long as you do not distribute the modified version without my
  169.    consent.
  170.  
  171.  
  172.    Copyright
  173.    ---------
  174.  
  175.    If you modify this program, I would appreciate a copy of the new
  176.    source code.   I am holding the copyright on the source code, so
  177.    please don't delete my name from the program files or from the
  178.    documentation.
  179.  
  180.  
  181. SUPPORT
  182. =======
  183.  
  184.    I work very hard to produce a software package of the highest quality
  185.    and functionality.  I try to look into all reported bugs, and will
  186.    generally fix reported problems within a few days.
  187.  
  188.    Since this is user supported software under the SourceWare concept,
  189.    I don't expect you to contribute if you don't like it or if it
  190.    doesn't meet your needs.
  191.  
  192.    If you have any questions, bugs, or suggestions, please contact 
  193.    me at: 
  194.          The Tool Shop BBS
  195.        (602) 279-2673 (2400) - Free node
  196.        (602) 264-3969 (HST 9600)
  197.        (602) 279-0230 (Hayes V9600)
  198.  
  199.    The latest version is always available for downloading. 
  200.  
  201.    Enjoy!     Samuel H. Smith
  202.               Author and Sysop of The Tool Shop.
  203.  
  204.